flashheart
==========

Flashheart is a tool for flashing compatible BIOS chips using a UM232H
device. It is intended for flashing the BIOS chips of Thinkpad laptops
with Libreboot. It worked for me (and then I uploaded the code).

The UM232H board has fairly good security properties in that all of
the intentionally mutable state is stored on an external EEPROM chip
located on the underside of the board. This EEPROM chip can be removed
with pliers without affecting basic use of the device (desoldering
would be the preferred way to remove it, but that is tricky due to
unfavorable geometry).

The software may work with other BIOS chips as well. Please check the
correspondence between the commands sent in the code and the datasheet
of the chip (and don't blame me if something does wrong).

Flashheart requires libmpsse from https://github.com/devttys0/libmpsse
(which requires libftdi and libusb).

Basic usage documentation may be found in the mk.sh file, which is the
compilation script. There is no Makefile because the program compiles
with a single gcc command.

this file is part of the "flashheart" software program

it is hereby placed in the PUBLIC DOMAIN by its author

there is NO WARRANTY, whether express or implied

by using this software, you agree to assume any and all risks of
such use, and that, to the maximum extent permitted by law, neither
the author of this software (the "author"), nor the party that
supplied this software to you (the "supplier"), is responsible for
any damage or loss caused to you or to any third party, even if
said damage or loss is directly attributable to your use of this
software, and even if the possibility of said damage or loss was
known to or reasonably forseeable by the author or the supplier or
both
